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Entorno multiplataforma de desarrollo visual con el cual es posible crear aplicaciones 
empresariales, servlets, applets y JavaBeans para el entorno Java 2. 
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Antes de empezar con la programación propiamente dicha, es importante señalar que toda aplicación que se desarrolle debe estar 
dentro del entorno de un proyecto. 


ara proyectos - Paso 1 de 3 NS ES] 


Seleccione el nombre yla plantilla del nuevo proyecto JBuñider 
Ihtroctuzca un nombre para el proyecto y la vía de acceso al drectorlo en que se ha ce guardar. 
Opcionalmente, puede seleccionar un proyecto ya existente como planta pora los valoras. 
Iniciales por detecto para este asistente. 


BN nontre: froyeco Teo fox x] 
Directorio: E Mocuments and Settings usuario Jbprojectiproyecto. a ha | 
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T Generar archivo de notes del proyecto 
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Compilar es el proceso de transformar el código fuente. En el caso especial de Java se transforma a bytecodes, un punto intermedio que hace po- 
sible que las aplicaciones sean multiplataforma con la ayuda de la máquina virtual, y generar de este modo los archivos .class ejecutables. 
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>>» PROGRAMANDO 











» La programación propiamente 
E dicha se hará a través del Content 
25 taport javex. swing, UlManeger) 
E Pane, lugar en donde por defec- 
5 j to, aparece el código fuente. Me- 


30 /fCceez la aplicación 


AA diante las pestañas ubicadas en 
pocas 1 necesa ss inacción de tama raras e os seso y. 3. su cto [a parte baja de este panel (File 
a peta view tab) puede moverse por las 


else 
frame validate()¿ 


distintas vistas de un archivo: 
Source (Fuente), Design (Diseño), 
Doc (Documentación), History (His- 
2% toría) y Bean (Semilla). La versión 

7 Enterprise soporta además la vis- 
ta UML que muestra el modelo lógico del proyecto. 
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» La vista de diseño es soportada solo por algunos archivos, por aquellas cla- 
ses contenedoras como las Frame y las Panel. Para editar un archivo en esta 
vista, se debe seleccionar del panel del proyecto el archivo adecuado, y lue- 
go elegir la pestaña Diseño en el Content Pane. 


» JBuilder cuenta con 
una amplia gama de 
controles y contenedo- 
res prediseñados, que 
pueden ser incluidos 
en las ventanas de ma- 
nera gráfica y sencilla. 
Existen desde controles 
que vienen incluidos en 
las librerías swing y awt, 
así como controles para MS 
bases de datos creados ' 

por Borland. En este sentido, se cuenta con una herramienta muy potente 
al tener un paquete de controles lo suficientemente variado como para de- 








>>» DEPURANDO 


» Depurar es el proceso de detectar, diagnosticar y corregir problemas y fa- 
llas, revisando paso a paso un código fuente. El tipo de fallas que se suelen 
corregir corresponden al nivel lógico y de ejecución, mas no al nivel sintácti- 
co. Una falla de nivel lógico se puede reconocer cuando las acciones que se 
realizan durante la ejecución del programa no son exactamente las que el 
programador tenía en mente. Por ejemplo, los errores lógicos pueden pro- 
ducirse cuando las variables contienen valores incorrectos, cuando los gráfi- 
cos no son los adecuados, o cuando los datos producidos por el programa 
son incorrectos. 


» Los errores de ejecución se dan cuando, por ejemplo, el programa inten- 
ta abrir un archivo que no existe o dividir un número por cero. Aunque este 
tipo de errores, en gran parte, son manejados por las excepciones en la 
parte de programación. 


» Toda esta tarea de depuración se hace básicamente con dos acciones, 
deteniendo la ejecución del programa en ciertos puntos del código, y colo- 






































sarrollar cualquier aplicación que se necesite. Pa- 
ra añadir algún control, debe seleccionarlo pri- 
mero de la lista de controles, y luego seleccionar 
el área sobre el Content Pane que desea que ocu- 
pe, haciendo un clic y arrastrando el mouse. 


» En esta vista se cuenta, además, con una ven- || 
tana de control de propiedades y eventos, que 
permite administrar fácilmente las características || 
visuales de los controles, y las acciones que se to- [| 
marán como respuesta ante ciertos sucesos que | 
se den (por ejemplo, un clic, una tecla presio- [A 
nada, etc.). Las propiedades visuales son edita- 
bles haciendo clic sobre la que desee modificar. 
Para implementar la respuesta ante un evento 
debe cambiar primero a la pestaña Events (Suce- 
sos) de la ventana de Control, y luego hacer do- 
ble clic sobre alguno de ellos. Esto aumentará el 
código necesario para programar la respuesta | 
ante el evento, por lo que automáticamente se 
cambiará la vista del archivo al fuente, y el cursor se posicionará donde debe 
escribir el código. 


» En la vista del código fuente puede ver un editor de código bastante fle- 
xible en cuanto al formato que quiera darle al mismo. Permite, entre otras 
cosas, configurar el teclado para atajos de teclas; controlar el formato del có- 
digo, en su sangrado y tabulación; opciones de resaltado de llaves correspon- 
dientes; y presentación de errores. Para entrar a configurar estas opciones se- 
leccione del menú principal la opción ToolseEditor options (HerramientaseOp- 
ciones del editor). 

En la pestaña “doc” puede ver la documentación generada de modo auto- 
mático mediante el javadoc, en formato HTML. Recuerde que dicha documen- 
tación puede ser ampliada comentando debidamente en el código fuente. 


cando puntos de inspección en los cuales se desea revisar los valores de va- 
riables o estado de los objetos. 


» Para depurar un programa bastará con seleccionar del menú principal la 
opción RuneDebug Project (EjecutareDepurar proyecto). El programa podría 
compilar el código antes de empezar con la depuración. A continuación apa- 
recerán una serie de botones debajo del panel de mensajes. Dichos boto- 
nes permiten controlar el código para la tarea de depuración. 





» Lo siguiente que debe hacerse es asignar puntos de interrupción o “break- 
points”, los cuales tienen la función de detener la ejecución del programa en 


36 if (packFrame) 


37 £rame.pack(); 

38 else 

39 frame, validate(); 
40 

41 // Centrar el marco 


43 Dimension framesize = frame.getSize(); 
44 if (fremeSsize.height > screenSize.height) 


46 if (framesize.wídth > screenSize. width) 
framesize. width = screenSize.width; 





el lugar en el que son puestos. Para colocar uno de éstos, basta con hacer un 
clic sobre el área gris que se encuentra al costado izquierdo del área de edi- 
ción del código fuente, a la altura de la línea en la que desea detener la eje- 
cución del programa. 





dde 





» Otro modo es seleccionando RunesAdd breakpoint (EjecutareAñadir punto 
de inspección), y luego se elige el tipo de punto de interrupción que se de- 
sea. La tercera opción es presionando el botón respectivo en la barra para 
depuración [8%%. Si elige interrupción por línea, aparecerá una ventana so- 
licitándo el nombre de la clase y la línea de código en la que desea colocar el 
punto de interrupción. 


» Una vez colocados estos puntos, tal vez pueda necesitarse conocer el va- 
lor de algunas variables al momento de la detención del programa. Para es- 
to, necesita volver a ejecutar el depurador y añadir puntos de observa- 
ción o inspección. Esto último puede hacerse sombreando la variable que de- 
sea seguir, y con el botón derecho abrir el menú contextual para seleccio- 
nar Add watch (Añadir punto de observación). Inmediatamente aparecerá 


>>» UTILIZANDO El JAVADOC 





un cuadro de diálogo con el nombre de la variable que se eligió. 
Opcionalmente puede colocarse una descripción de la variable. Otra 

forma de añadir un punto de inspección es seleccionando RuneAdd 

watch (Ejecutare Añadir punto de observación), o con el botón respecti- 
vo en la barra de depuración (38). pr 


» Si se vuelve a presionar el botón para reanudar la depuración $. y lue- 
go el botón para ver las variables inspeccionadas en la barra de depuración, 
se notará que en la ventana de mensajes aparecerán dichas variables 
con sus respectivos valores. El botón . ubicado en la barra de depuración 
detendrá totalmente la ejecución del programa. 

JBuilder, a través de la opción Help, incorpora tutoriales para las diferentes 
fases de creación y compilación de proyectos. 








ENE A 
per 
* Aquí debería colocarse una explicación de la utilidad de la clase 
*QGauthor nombre del autor de la clase 
ba 
public class CreadorPlantillas [ 
per 
*Aquí una explicación de lo que hace este método 
*Oparam parametro1 breve comentario sobre la variable “pa- 
rametro1” que 
* estamos pasándole al método aumentarOpciones 
*Oparam parametro2 y aquí para la variable “parámetro2” 
sb 
public void aumentarOpciones (int parametro1, float parame- 
11(9y)1 


metodoAumentar 
public void aumentarOpciones(int parametro1, 
float parametro2) 
Aquí una explicación de lo que hace este método 


Parameters: 
parametro! - breve comentario sobre la variable “parametro1” que 


estamos pasándole al método aumentarOpciones 
parametro2 - y aquí para la variable "parámetro2” 


Gauthor Nombre del autor de un código 











- JBuilder cuenta con un creador de recopilatorios, un asistente que permi- 
te agrupar los archivos y paquetes de un proyecto en un contenedor, para 
luego poder distribuirlo con facilidad a otros usuarios. Se puede crear una 
amplia gama de recopilatorios como, por ejemplo, applets, aplicaciones, clien- 
tes de aplicaciones J2EE, archivos recopilatorios JAR ejecutables, documen- 
tación, archivos fuente, aplicaciones web, y archivos recopilatorios JAR de 
aplicaciones. Aunque la versión Personal no lo permite, es posible crear tam- 
bién ejecutables nativos de nuestros proyectos. 


- Para acceder al asistente creador de recopilatorios, seleccione WizardseAr- 
chive builder (AsisteneseCreador de recopilatorios). Mostrará un cuadro de 


diálogo mediante el cual podrá crear los distintos tipos de re- 
copilación vistos antes. Para efectos didácticos tomaremos como 
ejemplo la creación de un recopilatorio de aplicación, el cual puede 
ser creado en 6 pasos: 


1. Elija este tipo de recopilatorio, Application (Aplicación). 


2. Elija el nombre del nodo sobre el cual se almacenarán los archivos 
resultantes del proceso de recopilación (meramente referencial); además, 
puede elegir el nombre del archivo de salida (con extensión ” jar”). 


3. Elija todos los archivos que se incluirán en el recopilatorio. Por de- 
fecto aparecerá la opción All classes and resources (Todas las clases y re- 
cursos). 


4. Enel cuarto y quinto paso, al estar creando un recopilatorio simple, 
no se modificará nada. Déle clic al botón Next (Siguiente). 


5. Elija la clase principal del proyecto, es decir, aquella que contiene 
al método maín. 


6. Hecho esto, en el panel del proyecto aparecerá un nodo con el nom- 
bre que haya especificado. Dé un clic con el botón derecho del mouse so- 
bre el nodo para que aparezca el menú contextual y seleccione Generate 
(Generar de nuevo). Ahora tendrá la aplicación completa en un solo archi- 
vo, que puede ser ejecutada mediante el comando jar -nombreArchivo. 





Es posible añadir, eliminar y configurar atajos de teclas. Seleccione del me- 
nú principal Herramientase Opciones del IDE. En la pestaña Visualizador, el 
botón Personalizar muestra un cuadro de diálogo con todas las teclas rápi- 
das configuradas. Podrían presentarse algunos conflictos si se está utilizan- 
do el escritorio KDE en Linux. 


- JBuilder posee asistentes que sirven para implementar interfases y mo- 
dificar métodos de clases ya implantadas de modo rápido y sencillo. Para 
acceder a estos asistentes basta con seleccionar la opción Wizards (Asisten- 
tes) del menú principal, y luego elegir el asistente que se desee (para Inter- 
fases o Métodos). - 


Una aplicación de base de datos es aquella que accede a datos almacenados y permite visualizarlos, así como modificarlos o manipularlos 
si fuera necesario. 


En la mayoría de los casos, los datos se almacenan en bases de datos di- 
señadas expresamente para ese fin. Sin embargo -y esto no es menos váli- 
do-—, también se pueden almacenar en archivos de texto (o con otro forma- 
to). La diferencia estará marcada por las ventajas que presentan estas bases 
de datos —con muchas funciones comunes disponibles para el programador 
sobre el tratamiento que se debe hacer en el caso de trabajar con archivos 
de texto con nuestro formato particular. 


- JBuilder permite acceder y manipular la información que se encuentre al- 
macenada en una base de datos haciendo uso de las propiedades, los mé- 
todos y los sucesos definidos en los paquetes DataSet de la biblioteca de com- 
ponentes DataExpress, en combinación con el paquete dbSwing. 


Cuando una aplicación solicita información de una fuente de datos, 
como una base de datos, se denomina aplicación cliente. 


Cuando una aplicación gestiona solicitudes de datos de varios clien- 
tes se denomina aplicación servidor, y se le conoce comúnmente como un 
Sistema de gestión de bases de datos (SGBD). 


Las aplicaciones JBuilder se comunican con servidores de bases de datos a 


través de la API JDBC, que es la especificación de conectividad con bases 
de datos de Sun. JDBC es la API Java estándar para acceso y manipulación 
de información en bases de datos. Las aplicaciones de bases de datos JBuil- 
der logran conectarse con cualquier base de datos que tenga un controla- 
dor JDBC. 


- DataExpress es un paquete de clases e interfases de Borland que permiten 
el acceso básico a datos. Este paquete también define clases básicas de 
proveedor y almacén, así como una clase abstracta de DataSet que se extien- 
de a otros objetos DataSet. Estas clases así definidas posibilitan el acceso a la 
información almacenada en bases de datos y otras fuentes de datos. 


Una aplicación simple para conectarse a una base de datos se puede lo- 
grar con tres componentes básicos: 


Los componentes Database 
Los componentes QueryDataset 
El paquete dbSwing 


e son específicos de JDBE y gestionan las co- 
nexiones con JDBC. Para acceder a datos utilizando un componente 











QueryDataSet, deberá asignar a la propiedad DataBase del mismo un com- 
ponente Database que haya sido instanciado. Una base de datos puede es- 
tar compartida por varios conjuntos de datos, siendo este modo de trabajo 
lo que sucede más a menudo. 


o es un DataSet específico de JDBC que 
gestiona un proveedor de datos de JDBC, como se define en la propiedad 
query. Mediante el uso de un componente QueryDataSet en JBuilder se pue- 
de extraer datos de una fuente de datos a un componente StorageData- 
Set. Este proceso se denomina suministro. Una vez suministrados los datos, 
pueden visualizarse y utilizarse localmente en componentes enlazados a da- 
tos. Los componentes QueryDataSet utilizan sentencias SQL para acceder o 
suministrar datos desde la base de datos. 


o permite generar aplicaciones de base de datos que 
aprovechan la arquitectura de los componentes Swing de Java. Además de las 
subclases enlazadas a datos que incorporan de origen la mayoría de los com- 
ponentes Swing, dbSwing incluye varias utilidades diseñadas específicamente 
para el desarrollo de aplicaciones basadas en DataExpress y JData Store. En la si- 








guiente lista se indican algunos de los componentes dbSwina dis- 
ponibles en la pestaña dbSwing de la paleta de componentes: 


— TableScrollPane 
-JdbTable 
-—JdbNavToolBar 
-JdbStatusLabel 
-JdbTextArea 
--JdbComboBox 
—JdbLabel 

2 JdbList 
-JdbTextPane 
-JdbTextField 


ofrece importantes ventajas frente a Swing, como una mayor 
variedad de funciones y la posibilidad de enlazar con datos. Además, do 
Swing es ligero, su aspecto visual puede simular el de muchas plataformas 
diferentes y cumple estrictamente los estándares de Swing. Si desea obtener 
más información sobre el paquete dbSwing, consulte la documentación 4% 








A continuación se explica la forma de configurar una aplicación de base de datos sencilla. La consulta que se va a utilizar en estos ejemplos 
es: SELECT *FROMI CUENTA. Esta sentencia SQL selecciona todas las columnas de una tabla denominada CUENTA de una base de datos ficti- 


cia ubicada en un servidor de base de datos local. 


- Para configurar una aplicación para su uso con los ejemplos: 
Cree una aplicación visual como se ha explicado anteriormente 


Active el diseñador de interfaces de usuario, seleccionando la pesta- 
ña Diseño. 


Haga clic en el componente Database de la pestaña DataExpress de la 
Paleta de componentes, y a continuación haga clic en el árbol de compo- 
nentes o en el diseñador de interfases de usuario para añadir el componen- 
te a la aplicación. 


Abra el editor de la propiedad Connection del componente Database 
creado, seleccionándolo y haciendo doble clic en el botón puntos suspensi- 
vos de la propiedad connection en el Inspector. Asigne valores a las propieda- 
des de conexión: La URL de conexión apunta al host donde se encuentra la 
base de datos; en nuestro caso, base de datos local. Se debe seleccionar ade- 
más el nombre de usuario y la contraseña con la cual deseamos conectarnos. 


- El cuadro de diálogo Connection contiene un botón Probar conexión. Púl- 
selo para comprobar que las propiedades de conexión tienen los valores co- 
rrectos. Los resultados del intento de conexión se muestran en el área de es- 
tado. Cuando la conexión sea satisfactoria, pulse Aceptar. 


Para poder realizar una consulta, añada un componente QueryDataSet 
al diseñador, haciendo clic en el componente QueryDataSet de la pestaña 
DataExpress, y después haga clic en el árbol de componentes. Seleccione 
en el Inspector la propiedad query del componente QueryDataSet, pulse 
el botón de puntos suspensivos para que se abra el cuadro de diálogo Query- 
Descriptor y asigne valores a las siguientes propiedades: 


nombreBaseDatos 


Haga clic sobre Probar consulta para cerciorarse de que se ejecuta correc- 
tamente. Cuando en el área de estado se indique Correcto, cierre el cuadro 
de diálogo pulsando Aceptar. 


- Para ver los datos en la aplicación, añada los siguientes componentes a la 
interfase y asócielos al conjunto de datos como se explica a continuación: 


- Seleccione contentPane (BorderLayout) y asigne a su propiedad layout 
el valor null. > 


- Coloque un JdbNavToolBar en la zona de la parte superior del panel, en 
el diseñador de interfases. Dicho componente se asocia automáticamente 
al objeto DataSet que tiene el foco, por lo que no es necesario definir su 
propiedad dataSet. 


- Coloque un JdbStatusLabel en la zona de la parte inferior del panel, en 
el diseñador de interfases. Este componente se asocia automáticamente al 
objeto DataSet que tiene el foco, por lo que no es necesario asignar valo- 
res a su propiedad dataSet. 


Añada un componente TableScrollPane de la pestaña dbSwing al cen- 
tro del panel, en el diseñador de interfases. 


Coloque un componente JdbTable en el centro del componente tableS- 
crollPane creado anteriormente y asigne a su propiedad dataSet como va- 
lor el nombre del componente queryDataSet. Puede observar que en este 
momento el diseñador muestra datos dinámicos. 


Seleccione EjecutareEjecutar proyecto para ejecutar la aplicación y exa- 
minar el conjunto de datos. En la etiqueta de estado de esta aplicación se 
ve el número de registros visibles. Cuando la aplicación se ejecuta por pri- 
mera vez, en la etiqueta de estado se puede leer Registro 1 de “N” (don- 
de “N” muestra el número de filas recuperadas en el conjunto de datos de 
cada aplicación). : 





